headerbar: Rename custom-title to title-widget

Now that all the other title-related properties are gone, custom title can
have a more mundane name.

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index 9aadbe1999a8d7713aa4dda92dee2268bdb224f0..e0c375cc404cddb175f6c4b6b4c1818d6cbdf21a 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -5579,8 +5579,8 @@ gtk_action_bar_get_type
 <TITLE>GtkHeaderBar</TITLE>
 GtkHeaderBar
 gtk_header_bar_new
-gtk_header_bar_set_custom_title
-gtk_header_bar_get_custom_title
+gtk_header_bar_set_title_widget
+gtk_header_bar_get_title_widget
 gtk_header_bar_pack_start
 gtk_header_bar_pack_end
 gtk_header_bar_set_show_title_buttons

diff --git a/gtk/gtkappchooserdialog.c b/gtk/gtkappchooserdialog.c
index ec56103cd3c5a4bbc1b76aff831a90a293ab0a94..477fc6089713f90c539745e77f72dbb9b08acdb4 100644 (file)
--- a/gtk/gtkappchooserdialog.c
+++ b/gtk/gtkappchooserdialog.c
@@ -244,7 +244,7 @@ set_dialog_properties (GtkAppChooserDialog *self)
       gtk_widget_add_css_class (label, GTK_STYLE_CLASS_SUBTITLE);
       gtk_widget_set_parent (label, box);
 
-      gtk_header_bar_set_custom_title (GTK_HEADER_BAR (header), box);
+      gtk_header_bar_set_title_widget (GTK_HEADER_BAR (header), box);
     }
   else
     {

diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index c7d6cec1c67adaa3b36c0c2960c966d4cfbefde3..4f5e9f6ca4cf9bd485ba8765fe746aeb3ba0d820 100644 (file)
--- a/gtk/gtkfilechooserdialog.c
+++ b/gtk/gtkfilechooserdialog.c
@@ -507,7 +507,7 @@ setup_search (GtkFileChooserDialog *dialog)
                                    translate_subtitle_to_visible,
                                    NULL, NULL, NULL);
 
-      gtk_header_bar_set_custom_title (GTK_HEADER_BAR (header), box);
+      gtk_header_bar_set_title_widget (GTK_HEADER_BAR (header), box);
 
       gtk_container_forall (GTK_CONTAINER (header), add_button, dialog);
     }
@@ -549,12 +549,12 @@ setup_save_entry (GtkFileChooserDialog *dialog)
       gtk_container_add (GTK_CONTAINER (box), label);
       gtk_container_add (GTK_CONTAINER (box), entry);
 
-      gtk_header_bar_set_custom_title (GTK_HEADER_BAR (header), box);
+      gtk_header_bar_set_title_widget (GTK_HEADER_BAR (header), box);
       gtk_file_chooser_widget_set_save_entry (GTK_FILE_CHOOSER_WIDGET (priv->widget), entry);
     }
   else if (!need_entry && priv->has_entry)
     {
-      gtk_header_bar_set_custom_title (GTK_HEADER_BAR (header), NULL);
+      gtk_header_bar_set_title_widget (GTK_HEADER_BAR (header), NULL);
       gtk_file_chooser_widget_set_save_entry (GTK_FILE_CHOOSER_WIDGET (priv->widget), NULL);
     }
 

diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 09363718513234e32672138b5f21724eebf3a551..5414cb56ce3a1eb53aace48de1cc3de46c44ac70 100644 (file)
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -64,7 +64,7 @@
  * ├── box.start
  * │   ├── windowcontrols.start
  * │   ╰── [other children]
- * ├── [Custom Title]
+ * ├── [Title Widget]
  * ╰── box.end
  *     ├── [other children]
  *     ╰── windowcontrols.end
@@ -99,7 +99,7 @@ struct _GtkHeaderBarPrivate
   GtkWidget *end_box;
 
   GtkWidget *title_label;
-  GtkWidget *custom_title;
+  GtkWidget *title_widget;
 
   gboolean show_title_buttons;
   gchar *decoration_layout;
@@ -113,7 +113,7 @@ struct _GtkHeaderBarPrivate
 
 enum {
   PROP_0,
-  PROP_CUSTOM_TITLE,
+  PROP_TITLE_WIDGET,
   PROP_SHOW_TITLE_BUTTONS,
   PROP_DECORATION_LAYOUT,
   LAST_PROP
@@ -195,7 +195,7 @@ update_default_decoration (GtkHeaderBar *bar)
           }
     }
 
-  if (have_children || priv->custom_title != NULL)
+  if (have_children || priv->title_widget != NULL)
     gtk_widget_remove_css_class (GTK_WIDGET (bar), "default-decoration");
   else
     gtk_widget_add_css_class (GTK_WIDGET (bar), "default-decoration");
@@ -261,21 +261,23 @@ construct_title_label (GtkHeaderBar *bar)
 }
 
 /**
- * gtk_header_bar_set_custom_title:
+ * gtk_header_bar_set_title_widget:
  * @bar: a #GtkHeaderBar
- * @title_widget: (allow-none): a custom widget to use for a title
+ * @title_widget: (allow-none): a widget to use for a title
  *
- * Sets a custom title for the #GtkHeaderBar.
+ * Sets the title for the #GtkHeaderBar.
  *
- * The title should help a user identify the current view. This
- * supersedes the window title label. To achieve the same style as
- * the builtin title, use the “title” style class.
+ * When set to %NULL, the headerbar will display the title of the window it is
+ * contained in.
  *
- * You should set the custom title to %NULL, for the window title
- * label to be visible again.
+ * The title should help a user identify the current view. To achieve the same
+ * style as the builtin title, use the “title” style class.
+ *
+ * You should set the title widget to %NULL, for the window title label to be
+ * visible again.
  */
 void
-gtk_header_bar_set_custom_title (GtkHeaderBar *bar,
+gtk_header_bar_set_title_widget (GtkHeaderBar *bar,
                                  GtkWidget    *title_widget)
 {
   GtkHeaderBarPrivate *priv = gtk_header_bar_get_instance_private (bar);
@@ -284,24 +286,18 @@ gtk_header_bar_set_custom_title (GtkHeaderBar *bar,
   if (title_widget)
     g_return_if_fail (GTK_IS_WIDGET (title_widget));
 
-  /* No need to do anything if the custom widget stays the same */
-  if (priv->custom_title == title_widget)
+  /* No need to do anything if the title widget stays the same */
+  if (priv->title_widget == title_widget)
     return;
 
-  if (priv->custom_title)
-    {
-      GtkWidget *custom = priv->custom_title;
-
-      priv->custom_title = NULL;
-      gtk_widget_unparent (custom);
-    }
+  g_clear_pointer (&priv->title_widget, gtk_widget_unparent);
 
   if (title_widget != NULL)
     {
       GtkLayoutManager *layout = gtk_widget_get_layout_manager (GTK_WIDGET (bar));
-      priv->custom_title = title_widget;
+      priv->title_widget = title_widget;
 
-      gtk_widget_insert_after (priv->custom_title, GTK_WIDGET (bar), priv->start_box);
+      gtk_widget_insert_after (priv->title_widget, GTK_WIDGET (bar), priv->start_box);
       gtk_center_layout_set_center_widget (GTK_CENTER_LAYOUT (layout), title_widget);
 
       g_clear_pointer (&priv->title_label, gtk_widget_unparent);
@@ -312,27 +308,27 @@ gtk_header_bar_set_custom_title (GtkHeaderBar *bar,
         construct_title_label (bar);
     }
 
-  g_object_notify_by_pspec (G_OBJECT (bar), header_bar_props[PROP_CUSTOM_TITLE]);
+  g_object_notify_by_pspec (G_OBJECT (bar), header_bar_props[PROP_TITLE_WIDGET]);
 }
 
 /**
- * gtk_header_bar_get_custom_title:
+ * gtk_header_bar_get_title_widget:
  * @bar: a #GtkHeaderBar
  *
- * Retrieves the custom title widget of the header. See
- * gtk_header_bar_set_custom_title().
+ * Retrieves the title widget of the header. See
+ * gtk_header_bar_set_title_widget().
  *
- * Returns: (nullable) (transfer none): the custom title widget
+ * Returns: (nullable) (transfer none): the title widget
  *    of the header, or %NULL if none has been set explicitly.
  */
 GtkWidget *
-gtk_header_bar_get_custom_title (GtkHeaderBar *bar)
+gtk_header_bar_get_title_widget (GtkHeaderBar *bar)
 {
   GtkHeaderBarPrivate *priv = gtk_header_bar_get_instance_private (bar);
 
   g_return_val_if_fail (GTK_IS_HEADER_BAR (bar), NULL);
 
-  return priv->custom_title;
+  return priv->title_widget;
 }
 
 static void
@@ -365,7 +361,7 @@ gtk_header_bar_dispose (GObject *object)
 {
   GtkHeaderBarPrivate *priv = gtk_header_bar_get_instance_private (GTK_HEADER_BAR (object));
 
-  g_clear_pointer (&priv->custom_title, gtk_widget_unparent);
+  g_clear_pointer (&priv->title_widget, gtk_widget_unparent);
   g_clear_pointer (&priv->title_label, gtk_widget_unparent);
 
   G_OBJECT_CLASS (gtk_header_bar_parent_class)->dispose (object);
@@ -395,8 +391,8 @@ gtk_header_bar_get_property (GObject    *object,
 
   switch (prop_id)
     {
-    case PROP_CUSTOM_TITLE:
-      g_value_set_object (value, priv->custom_title);
+    case PROP_TITLE_WIDGET:
+      g_value_set_object (value, priv->title_widget);
       break;
 
     case PROP_SHOW_TITLE_BUTTONS:
@@ -423,8 +419,8 @@ gtk_header_bar_set_property (GObject      *object,
 
   switch (prop_id)
     {
-    case PROP_CUSTOM_TITLE:
-      gtk_header_bar_set_custom_title (bar, g_value_get_object (value));
+    case PROP_TITLE_WIDGET:
+      gtk_header_bar_set_title_widget (bar, g_value_get_object (value));
       break;
 
     case PROP_SHOW_TITLE_BUTTONS:
@@ -527,8 +523,8 @@ gtk_header_bar_forall (GtkContainer *container,
         }
     }
 
-  if (priv->custom_title != NULL)
-    (* callback) (priv->custom_title, callback_data);
+  if (priv->title_widget != NULL)
+    (* callback) (priv->title_widget, callback_data);
 
   if (priv->end_box)
     {
@@ -571,10 +567,10 @@ gtk_header_bar_class_init (GtkHeaderBarClass *class)
   container_class->forall = gtk_header_bar_forall;
   container_class->child_type = gtk_header_bar_child_type;
 
-  header_bar_props[PROP_CUSTOM_TITLE] =
-      g_param_spec_object ("custom-title",
-                           P_("Custom Title"),
-                           P_("Custom title widget to display"),
+  header_bar_props[PROP_TITLE_WIDGET] =
+      g_param_spec_object ("title-widget",
+                           P_("Title Widget"),
+                           P_("Title widget to display"),
                            GTK_TYPE_WIDGET,
                            G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS);
 
@@ -625,7 +621,7 @@ gtk_header_bar_init (GtkHeaderBar *bar)
   GtkHeaderBarPrivate *priv = gtk_header_bar_get_instance_private (bar);
   GtkLayoutManager *layout;
 
-  priv->custom_title = NULL;
+  priv->title_widget = NULL;
   priv->decoration_layout = NULL;
   priv->state = GDK_SURFACE_STATE_WITHDRAWN;
 
@@ -651,7 +647,7 @@ gtk_header_bar_buildable_add_child (GtkBuildable *buildable,
                                     const gchar  *type)
 {
   if (g_strcmp0 (type, "title") == 0)
-    gtk_header_bar_set_custom_title (GTK_HEADER_BAR (buildable), GTK_WIDGET (child));
+    gtk_header_bar_set_title_widget (GTK_HEADER_BAR (buildable), GTK_WIDGET (child));
   else if (g_strcmp0 (type, "start") == 0)
     gtk_header_bar_pack_start (GTK_HEADER_BAR (buildable), GTK_WIDGET (child));
   else if (g_strcmp0 (type, "end") == 0)

diff --git a/gtk/gtkheaderbar.h b/gtk/gtkheaderbar.h
index 3da4a96abeb3cf5b797c6385ed22506adf216da3..23334c546980d5a8337b9641dc6ac4f036d65d18 100644 (file)
--- a/gtk/gtkheaderbar.h
+++ b/gtk/gtkheaderbar.h
@@ -40,10 +40,10 @@ GDK_AVAILABLE_IN_ALL
 GtkWidget   *gtk_header_bar_new               (void);
 
 GDK_AVAILABLE_IN_ALL
-void         gtk_header_bar_set_custom_title  (GtkHeaderBar *bar,
+void         gtk_header_bar_set_title_widget  (GtkHeaderBar *bar,
                                                GtkWidget    *title_widget);
 GDK_AVAILABLE_IN_ALL
-GtkWidget   *gtk_header_bar_get_custom_title  (GtkHeaderBar *bar);
+GtkWidget   *gtk_header_bar_get_title_widget  (GtkHeaderBar *bar);
 GDK_AVAILABLE_IN_ALL
 void         gtk_header_bar_pack_start        (GtkHeaderBar *bar,
                                                GtkWidget    *child);

diff --git a/gtk/gtkshortcutswindow.c b/gtk/gtkshortcutswindow.c
index 935c0c3c741416395d0340335eeab92cec758571..f51f77dc31690420d55c4878eaf2033e0c528701 100644 (file)
--- a/gtk/gtkshortcutswindow.c
+++ b/gtk/gtkshortcutswindow.c
@@ -921,7 +921,7 @@ gtk_shortcuts_window_init (GtkShortcutsWindow *self)
 
   priv->title_stack = g_object_new (GTK_TYPE_STACK,
                                     NULL);
-  gtk_header_bar_set_custom_title (priv->header_bar, GTK_WIDGET (priv->title_stack));
+  gtk_header_bar_set_title_widget (priv->header_bar, GTK_WIDGET (priv->title_stack));
 
   /* Translators: This is the window title for the shortcuts window in normal mode */
   label = gtk_label_new (_("Shortcuts"));